home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 March / EnigmA AMIGA RUN 05 (1996)(G.R. Edizioni)(IT)[!][issue 1996-03][Skylink CD IV].iso / earcd / util3 / icnfgdgt.lha / IconifyGadget.readme < prev   
Text File  |  1996-01-25  |  10KB  |  226 lines
  1. Short: Adds iconify gadget to windows. BETA version.
  2. Author: Håkon Enger (henger@fys.uio.no)
  3. Uploader: henger@fys.uio.no
  4. Type: util/misc
  5. Version: 0.7 beta
  6.  
  7. NOTE: This is a beta version. If you use this program, it WILL cause
  8. your computer to crash, sooner or later. If you still want to try it,
  9. I would be grateful if you tell me when you find a bug.
  10.  
  11. CHANGES SINCE VERISON 0.6:
  12.  · Small error in gadget image, showing up with certain screen font
  13.    sizes corrected.
  14.  · Added Width and MoveRight parameters
  15.  · Configuring from ENV:IconifyGadget.config
  16.  
  17. Commodities/IconifyGadget                          Commodities/IconifyGadget
  18.  
  19.  
  20.     NAME
  21.         IconifyGadget - add iconify gadget to windows
  22.  
  23.  
  24.     USAGE
  25.         IconifyGadget [Screens {WORKBENCH|PUBLIC|ALL}] [IKey <keyseq>]
  26.                       [WBWindows {NO|ICONIFY|CLOSE}] [3DLook]
  27.                       [CX_Priority <pri>] [Width <width>] [MoveRight]
  28.  
  29.  
  30.     REQUIREMENTS
  31.  
  32.         Any Amiga computer with Workbench 2.0 or higher.
  33.  
  34.  
  35.     FUNCTION
  36.  
  37.         If you run a lot of programs that open windows on the Workbench
  38.         screen, the screen easily gets overcrowded. IconifyGadget helps
  39.         with this problem by adding an option to iconify windows. Windows
  40.         that are iconified are temporarily removed from view and replaced
  41.         by an icon. When the icon is double-clicked on, the window appears
  42.         again and the icon disappears. Iconifying windows with Iconify-
  43.         Gadget is done by clicking on a new gadget appearing to the left
  44.         of the "Zoom" gadget in the upper right corner of the window, or
  45.         by pressing a user-selectable key defined by the IKEY parameter.
  46.         Not all windows are iconifiable, see the DISCUSSION section below
  47.         for details. Also read the WARNING and BUGS sections below.
  48.  
  49.         IconifyGadget is a commodity, so it can be controlled by the
  50.         Commodities Exchange utility. Removing IconifyGadget is
  51.         dangerous if other programs have patched the library functions
  52.         that are patched by IconifyGadget. Se DISCUSSION.
  53.  
  54.         The gadget used is visually similar to the iconify gadget used by
  55.         MUI, which is also used by KCON. An alternate image is provided
  56.         and may be selected with the 3DLOOK switch. This image may be
  57.         preferred if you use "SysIHack".
  58.  
  59.         Which icon to use for different windows and windows that should
  60.         not get an iconify gadget may be specified in the file
  61.         ENV:IconifyGadget.config. Each line should contain a pattern for
  62.         the window title followed be any number of blanks, followed by
  63.         either the filename of an icon to use (without .info) or the
  64.         keyword "NotIconify" meaning that the window should not recieve
  65.         an iconify gadget. The pattern for the title is a standard
  66.         AmigaDOS pattern.
  67.  
  68.  
  69.     PARAMETERS
  70.  
  71.         All parameters can be used as tooltypes when started from WB or
  72.         as command line parameters when started from the Shell.
  73.  
  74.  
  75.         SCREENS     Define which screen(s) the programs will affect.
  76.                     Specifying WORKBENCH will only affect windows on the
  77.                     Workbench screen, PUBLIC will affect windows on all
  78.                     public screens, and ALL will affect windows on all
  79.                     screens. Since the icons appear only on the WB screen,
  80.                     iconifying windows on other screens seems a little
  81.                     weird, but if you want it, there it is. Default is
  82.                     WORKBENCH
  83.  
  84.         IKEY        Specify a key sequence that will iconify the active
  85.                     window. Default is none.
  86.  
  87.         WBWINDOWS   What to do with Workbench windows. Since WB windows
  88.                     (disks, drawers etc.) already have icons, there is
  89.                     really no use in creating another. Still, if you
  90.                     want to iconify WB windows just like all other,
  91.                     specify ICONIFY. If you want an iconify gadget for
  92.                     completeness, but not to create another icon, specify
  93.                     CLOSE. This will make the iconify gadget act exactly
  94.                     like the close gadget. Default is NO.
  95.  
  96.         3DLOOK      For those who like to fool around with sysihack, this
  97.                     switch gives an alternate image for the gadget.
  98.  
  99.         CX_PRIORITY Priority for the commodities exchange broker.
  100.  
  101.         WIDTH       Width of the iconify gadget. If not specified, the
  102.                     standard width will be used, based on the resolution
  103.                     of the screen.
  104.  
  105.         MOVERIGHT   Move the gadget right if there is no zoom gadget.
  106.                     This might be confusing since the iconify gadget might
  107.                     be mistaken for the zoom gadget, so it's an option.
  108.  
  109.  
  110.     DISCUSSION
  111.  
  112.         This program is one I have wanted to write ever since I got hold
  113.         of Ewout Walraven's "Iconify". That program made it possible to
  114.         iconify most windows by pressing ctrl and double-clicking in
  115.         them, but I wanted a gadget to click on! So here it is, finally
  116.         in beta version. Comments and bugreports are welcomed!
  117.  
  118.         I owe a lot to Ewout Walraven for this program, even if he
  119.         doesn't know it himself. The method used for iconifying the
  120.         windows was inspired by "Iconify", and also the icon was stolen
  121.         from there.
  122.  
  123.         The program works by adding a gadget to all windows that are
  124.         iconifyable. That means that they are refreshable and not gimme-
  125.         zerozero or borderless. If the window already has a gadget in the
  126.         position where IconifyGadget adds it's gadget, the window is
  127.         considered not iconifyable by IconifyGadget. This is usually
  128.         because the program that uses the window has provided a way
  129.         to iconify thw window. The windows are iconified by resizing and
  130.         moving the layer of the window to the bottom left corner of the
  131.         screen. (Clicking in this corner may give strange results for
  132.         some windows!) The window is never really removed from the screen,
  133.         so the screen can not be closed if there are any iconified windows
  134.         left.
  135.  
  136.         When the windows are iconified, they will be represented by an
  137.         AppIcon on the Workbench screen. Double-clicking on this icon will
  138.         bring back to full sized window to the front of the screen.
  139.  
  140.         IconifyGadget patches the following intuition.library functions:
  141.         OpenWindow, OpenWindowTagList, CloseWindow, AddGadget and
  142.         WindowToFront. If a program that patches any of these is started
  143.         after IconifyGadget, it should be removed before IconifyGadget is
  144.         removed. Alternatively, you can use a utility such as PatchControl
  145.         to handle the patches.
  146.  
  147.  
  148.     WARNING
  149.  
  150.         Fooling around with other programs' windows is NOT a nice thing to
  151.         do. If you don't like to take chances, don't use this program.
  152.  
  153.  
  154.     BUGS
  155.  
  156.         This is a beta version, so there are probably lots of unknown bugs.
  157.  
  158.         Since this program seriously hacks the system, it's probably not
  159.         possible to eliminate all 'bugs' (cf the warning above). I'll try
  160.         to do my best, however.
  161.  
  162.         There is a that makes CPR crash if you try to add an iconify gadget
  163.         to it's windows. I have not been able to find out why this happens.
  164.  
  165.         The following bugs were reported by people trying v0.6:
  166.         · MUI3 windows get two iconify gadgets (mine and theirs).
  167.           Solution: Turn of iconifying for either MUI or IG (using the
  168.           config file). (First reported by Carl Seward)
  169.         · Workbench windows like Execute and Info can be iconified, but
  170.           since workbench is frozen while these windows show (not Info in
  171.           OS3.0+), the icons never show up and hence they cannot be un-
  172.           iconified. Solution: Use the config file to ban these windows
  173.           from iconifying. (First reported by John Gardi) 
  174.         · Adding an iconify gadget to the CPUsage meter of SuperDashBoard
  175.           causes a crash. Solution: Same as above (for now...)
  176.           (Also reported by John Gardi)
  177.         · Using the AppChange option of MCP causes a crash. Solution:
  178.           don't use it. (Sorry, but there's really not much I can do
  179.           about it.) (First reported by Troy Davis)
  180.         · Flemming Steffensen reported that the width of the gadget is
  181.           wrong on his machine. I don't know why, but if anybody else
  182.           have this problem, please let me know! Solution: use the
  183.           WIDTH parameter to set the width.
  184.  
  185.         Some windows mysteriously un-iconifies themselves if you click in
  186.         the lower right corner of the screen.
  187.  
  188.         Some windows are empty when they are un-iconified. This will
  189.         probably be solved in a later version.
  190.  
  191.         When you find a bug, please inform me on how it occured. If you
  192.         have the source code to the program that was making IconifyGadget
  193.         crash, it would be of great help to me if you could send that too.
  194.         My address (email and otherwise) is at the end of this document.
  195.  
  196.  
  197.     THANKS
  198.  
  199.         Thanks to Ewout Walraven for making the Iconify program.
  200.  
  201.         Thanks to everybody who reported bugs and had suggestions to the
  202.         first release of IconifyGadget.
  203.  
  204.  
  205.     COPYRIGHT
  206.  
  207.         IconifyGadget is Copyright © 1995 Håkon Enger
  208.  
  209.         This beta version may not be distributed without explicit
  210.         permission from the author. Such permission is given to the AmiNet
  211.         collection of Amiga software FTP sites.
  212.  
  213.  
  214.     AUTHOR
  215.  
  216.         Håkon Enger
  217.  
  218.         Email addresses: henger@fys.uio.no, haakone@ifi.uio.no. If one of
  219.         them bounces, try the other one.
  220.  
  221.         Regular mail should be addressed to:
  222.             Håkon Enger
  223.             Rikard Nordraaksveg 12
  224.             N-2400 Elverum
  225.             Norway
  226.